home *** CD-ROM | disk | FTP | other *** search
/ PC Media 3 / PC MEDIA CD03.iso / share / os2 / fliflc / readme.1st < prev    next >
Encoding:
Text File  |  1994-03-15  |  4.8 KB  |  135 lines
  1. FLIPLAY PACKAGE - FLI/FLC Animation support for MMPM/2
  2.  
  3. This package is a pre-release version and is provided "as is".
  4.  
  5. Author: John E. Parsons Internet: parsonsj@vnet.ibm.com
  6.  
  7. Contacts: Maria Ingold  Internet: ingoldm@bcrvmpc2.vnet.ibm.com
  8.           Lauren Post   Internet: lpost@bcrvm1.vnet.ibm.com
  9.  
  10. System Requirements
  11. -------------------
  12.  
  13. This program requires OS/2 2.1 GA with the MMPM/2 digital video
  14. extensions installed.  For good performance you will need a
  15. system which has SVGA or XGA display capabilities running in 256
  16. or 64K color mode.
  17.  
  18. Installation & Use
  19. ------------------
  20.  
  21. 1.) If you don't have MMPM/2 1.1 digital video installed then
  22.     install it and come back here after you reboot.
  23.  
  24. 2.) Type FLIFLC to automatically extract all the FLIPLAY files.
  25.  
  26. 3.) Copy ALL the FLIPLAY files to a directory somewhere on your
  27.     PC, then run MINSTALL on that directory.  Select the animation
  28.     package, press INSTALL and relax.
  29.  
  30. 4.) After a reboot, you can play FLI/FLC files with any application
  31.     which plays AVI.  For instance, our MMPM/2 digital video player, or
  32.     any OS/2 screen saver which supports AVI.  You can also simply
  33.     double click on the files.
  34.  
  35. 5.) For the best performance, make sure your display is in 256
  36.     or 64K color mode if possible.
  37.  
  38. 4.) Also included is a performance and TEST driver, AUTODESK.EXE,
  39.     so you can see the performance statistics and make the animation
  40.     loop.  Press the rewind button to make this option take effect.
  41.     You also have to press rewind after a movie plays to the end before
  42.     it can be played again.  The MMPM/2 CSD or the Manufacturing Refresh
  43.     CSD is needed to make this work.  Otherwise the error "Digital Video
  44.     Blowed Up!" "Invalid Stream Protocol Specified" will occur.
  45.  
  46.    >>> I'd also like to say CUA?  What's that???
  47.    >>> It's a TEST driver OK?
  48.  
  49. 5.) There is currently a debug environment variable PM_DEBUG which
  50.     will force all output through PM if set.  Otherwise the driver will
  51.     utilize direct VRAM decode.
  52.  
  53. File Definitions
  54. ----------------
  55.  
  56. AUTODESK.EXE ................... The player
  57. AUTOPROC.DLL ................... The FLI/FLC I/O Proc dll
  58. SSMINI.DLL ..................... Yanked out of the Manufacturing Refresh CSD
  59. SVSH.DLL ....................... Yanked out of the Manufacturing Refresh CSD
  60.  
  61. ANIMATE.ICO .................... Icon for the player and Minstall
  62. CONTROL.SCR .................... Script file for Minstall
  63. AUTOPROC.INI ................... Needed for Minstall
  64. AUTOPROC.LST ................... Needed for Minstall
  65.  
  66. AA05.FLI ....................... Sample flics
  67. BACKHOE.FLI ....................     "
  68. CAMERA.FLI .....................     "
  69. MARVIN.FLI .....................     "
  70.  
  71. README.1ST ..................... This readme
  72.  
  73. Current Limitations
  74. -------------------
  75.  
  76. 1.) Performance may be poor for any color depths other than
  77.     256 or 64K colors.
  78.  
  79. 2.) If any compressed frame in the animation exceeds 188K bytes,
  80.     the player will terminate with the bogus error of "invalid
  81.     buffer length".
  82.  
  83. 3.) Seeking is currently disabled.  If you try it, the animation
  84.     will start all over again.
  85.  
  86. 4.) Palette animation is not supported.  Nothing bad
  87.     will happen, but the visual results may not be what you
  88.     expect.
  89.  
  90. 5.) Clipping is currently brute force and low performance.  Also,
  91.     "holes" will be left in the animation when previously clipped
  92.     areas are uncovered.
  93.  
  94.  
  95. Known Bugs
  96. ----------
  97.  
  98. 1.) Stepping in the MMPM/2 1.1 digital video driver is not
  99.     reliable.  It usually steps two frames, or not at all.  There is
  100.     nothing I can do about this.  The MMPM/2 CSD fixes this
  101.     problem.
  102.  
  103.  
  104. Implementation Notes
  105. ====================
  106.  
  107.  
  108. General
  109. -------
  110.  
  111. The FLI/FLC animation support plugs into the MMPM/2 architecture as
  112. an IOProc and codec.  This allows the system to understand a completely
  113. new file format, and to decompress the FLI/FLC compressed frames.  No
  114. changes were made to standard MMPM/2 which ships in every copy of
  115. OS/2 2.1.
  116.  
  117. This approach was taken to allow all existing AVI applications to
  118. automagically play animation with no changes.  Some examples to date
  119. are screen savers, Builder/2, and our own MMPM/2 player.
  120.  
  121.  
  122. Parallel Audio
  123. --------------
  124.  
  125. Every time a FLI/FLC file is opened, a check is made to see if a
  126. corresponding *.WAV file exists.  If so, an audio track is interleaved
  127. on the fly during playback.  Performance will probably only be acceptable
  128. on a hard drive due to seeking between the two files.  Additionally,
  129. the audio will only remain synchronized if the system has adequate
  130. video performance.  The audio will not get behind, but it may get ahead
  131. for now.
  132.  
  133. The audio stops when the animation runs out.  If the audio file is too short,
  134. silence will be generated until the end of the animation.
  135.